[beta] Voice sign-in: resolve driver and create assignment

Resolves a driver by name within an organization via voice sign-in, then creates a driver-vehicle assignment via the Driver Assignment Service.

Rate limit: 100 requests/min (learn more about rate limits here).

To use this endpoint, select Write Assignments under the Assignments category when creating or editing an API token. Learn More.

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team.

POST /fleet/drivers/voice-sign-in/resolve-assignment

[beta] Voice sign-in: resolve driver and create assignment

cURL

curl --request POST \
  --url https://api.samsara.com/fleet/drivers/voice-sign-in/resolve-assignment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "driverName": "Jane Doe",
  "vehicleId": "281474978683353"
}
'

201

{
  "data": {
    "driverId": "1234567",
    "driverName": "Jane Doe"
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request body for resolving a driver assignment by driver name and vehicle ID.

driverName · string · required

The full name of the driver to resolve.

Example:

"Jane Doe"

vehicleId · string · required

The vehicle ID. This can be either a unique Samsara ID or an external ID for the vehicle.

Example:

"281474978683353"

Response

201

application/json

Created response.

data · object · required

Response body containing the resolved driver information.

Show child attributes